home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / wildcat / pdmnu332.zip / PDMENU.TXT < prev    next >
Text File  |  1996-09-09  |  19KB  |  419 lines
  1.  
  2.  
  3.  
  4.                               
  5.  
  6.                   P U L L - D O W N   M E N U   S Y S T E M
  7.  
  8.  
  9.  
  10.        Version 3.32              PD MENU               For Wildcat! 5
  11.       ________________________________________________________________
  12.  
  13.        Developed by Crazy Larry's Online Art             503-357-2710
  14.        http://www.europa.com/~cloa                    cloa@europa.com
  15.       ________________________________________________________________
  16.        
  17.          Crazy Larry's Online Art is a division of Bitwise Computers       
  18.                P.O. Box 829  Forest Grove, Oregon 97116-0829
  19.  
  20.  
  21.  
  22.                              Table of Contents
  23.  
  24.  
  25.            Overview ........................................... 2
  26.  
  27.            Packing List ....................................... 2
  28.  
  29.            Upgrading from a Wildcat 4 version ................. 2
  30.  
  31.            Installing PD Menu ................................. 3
  32.  
  33.            Maintaining PD Menu ................................ 4
  34.  
  35.            Using the PD Menu Editor ........................... 5
  36.  
  37.            Editing Menu properties ............................ 5
  38.  
  39.            Changing the color of your menus ................... 6
  40.  
  41.            Describing your Menus .............................. 6
  42.  
  43.            Using your own ANSI's with PD Menu ................. 6
  44.  
  45.            Selecting your own personal background menu ........ 6
  46.  
  47.            Disabling PD Menu .................................. 7
  48.  
  49.            Shareware Notice ................................... 7
  50.  
  51.            Disclaimer ......................................... 7
  52.  
  53.            Your suggestions are welcome ....................... 7
  54.  
  55.            Aknowledgements .................................... 7
  56.  
  57.  
  58.  
  59.  
  60.                                                                Page 2
  61.  
  62.  
  63.       OVERVIEW
  64.       ________________________________________________________________
  65.       The PD Menu (Pull-Down Menu) System  was originally developed to
  66.       take the work out of  designing menu display files,  by creating
  67.       them automatically.  This also provided a new,  modern interface
  68.       for the text-based Wildcat! BBS.
  69.  
  70.       Version 3.0 (and above) now goes one step further by interfacing
  71.       directly with Wildcat! 5.  PD Menu now replaces the internal WC!
  72.       structure that  dynamically creates your  menus for you when the
  73.       appropriate menu display files (i.e. main5.bbs) do not exist.
  74.  
  75.       For more information on how this program works,  be sure to read
  76.       the following section on installation.  I think you'll find that
  77.       this one program  can free up a lot of the time  required to run
  78.       and maintain a Wildcat! 5 BBS.
  79.  
  80.  
  81.       PACKING LIST
  82.       ________________________________________________________________
  83.       The  following files should be included in the original archive.
  84.  
  85.       MENU.WCX             The actual program executable file
  86.       PDMENU.WCX           The configuration program
  87.       WCMENU.WCX           Used if a caller logs on without color
  88.       PDUSER.WCX           Allows users to select a background ANSI
  89.       PDMENU.TXT           This document
  90.       PDMENU.BBS           This is a sample PD Menu background ANSI
  91.       PDMENUn.BBS          User-Available menu choices (n = 1 to 8)
  92.       FILE_ID.DIZ          Long file description
  93.       DESC.SDI             Short file description
  94.       REGISTER.FRM         The registration form for all CLOA products
  95.  
  96.       If any of these files are missing,  please do not distribute, or
  97.       use this program.  Contact the support BBS at 503-357-2710 for a
  98.       copy of the latest version.  Please distribute this program only
  99.       in with all the original files intact!
  100.  
  101.  
  102.       UPGRADING FROM THE WILDCAT! 4 VERSION OF PD MENU
  103.       ________________________________________________________________
  104.       When you upgraded your BBS to Wildcat! 5, you probably found out
  105.       the way I did,  that a lot of things have changed,  and that you
  106.       would have to spend some time re-learning it.  Well,  it doesn't
  107.       stop there folks!   This version of PD Menu is totally different
  108.       than all prior versions.   You no longer have to re-create menus
  109.       to get PD Menu to work!  However, none of your old PD Menus will
  110.       be supported.
  111.  
  112.       If you registered a prior version of  PD Menu,  you will need to
  113.       copy the file PDMENU.KEY from your old Wildcat home directory to 
  114.       the new Wildcat! menu (C:\WC5\MENU),  or enter your registration
  115.       number in the PDMENU.WCX configuration program.
  116.  
  117.  
  118.  
  119.  
  120.                                                                Page 3
  121.  
  122.       INSTALLATION
  123.       ________________________________________________________________
  124.       The installation process for PD Menu should be very simple,  but
  125.       it is important to read this entire section.   Failure to follow
  126.       these steps can result in damage to some of your BBS data files.
  127.       Please read this section carefully!
  128.  
  129.       For this section of the manual I will be refering to the Wildcat
  130.       home directory as C:\WC5.   Please make note of this, and adjust
  131.       it for your needs.
  132.  
  133.       1]  Go to your language directory, (C:\WC5\LANGUAGE), and backup
  134.           the file WILDCAT.MNU.  To back up this file, simply create a
  135.           .ZIP file in a separate directory by adding this file to it.
  136.  
  137.           This step serves only to protect you from the possibility of
  138.           your data files becoming corrupted for ANY reason.
  139.  
  140.           If your system supports more than one launguage,  you should
  141.           back up each additional .MNU file as well.            
  142.  
  143.       2]  Go to your menu directory (C:\WC5\MENU), and backup all your
  144.           .BBS files.  As you did above.  You might want keep this new
  145.           .ZIP file in this directory.  If you plan to use PD Menu the
  146.           way it was intended, you can delete all your menu .BBS files
  147.           at this time.  You can, alternatively, create new menu files
  148.           to use as backgrounds for each individual menu. 
  149.  
  150.       3]  Place each of the "PDMENU*.BBS" files in your  Wildcat! menu
  151.           directoryWC5\MENU).  These are the background ANSI files for
  152.           PD Menu.  These files act similar to the way a *.BMP file is
  153.           used for a "Wallpaper" in that all too familiar program from
  154.           you know who.
  155.  
  156.       4]  Place files MENU.WCX, PDMENU.WCX, WCMENU.WCX, and PDUSER.WCX 
  157.           your Wildcat home directory (C:\WC5).
  158.  
  159.       5]  Run wcMenu,  and add the file PDMENU.WCX to your Sysop menu.
  160.           If you would like to allow your users to change select their
  161.           own background ANSI,  add the file PDUSER.WCX to a menu that
  162.           they will have access to. Be sure to set the access to these
  163.           files accordingly.  Refer to your Wildcat! System Operator's
  164.           Guide for information on how to add wcCodes to your menus.
  165.  
  166.       6]  Now log onto your BBS,  and goto EVERY menu you have defined
  167.           in wcMenu BEFORE you run PDMENU.WCX.   When you goto a menu,
  168.           PDMenu automatically creates a PDMENUn.CFG file for it.  The
  169.           program PDMENU.WCX is used for editing these configurations.
  170.  
  171.       7]  Once you have displayed every menu, run PDMENU.WCX from your
  172.           sysop menu.  This program allows you to configure all of the
  173.           properties of PD Menu.  More information on using the config
  174.           program is discussed later in this document.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                                                Page 4
  181.  
  182.       MAINTAINING PD MENU
  183.       ________________________________________________________________
  184.       Contrary to previous versions (1.0 to 2.2) of PD Menu, to change
  185.       any menu commands, security level settings, etc.,  you only need
  186.       to use wcMenu.  
  187.  
  188.       If you decide to add a menu to your system, be sure to visit the
  189.       menu first, before you PDMENU.WCX to edit it.  This is so that a
  190.       default PD Menu configuration file can be made for the menu.
  191.  
  192.       When displaying a menu,  PD Menu will use the information in the
  193.       description field from wcMenu.  By default, Wildcat! enters this
  194.       information in this format:
  195.  
  196.             [A] ............A menu command
  197.  
  198.       PD Menu will look for the command key, ("A" in this example), at
  199.       the second character in the description.  The description itself
  200.       will be pulled from the text after the third character.   If you 
  201.       prefer not to have the periods in the descriptions,  you need to 
  202.       use wcMenu to edit format the descriptions as you prefer.        
  203.  
  204.       The most critical thing to remember is that the command key must
  205.       be placed as the second position. You can also use wcMenu to add
  206.       separators to your menus.  To do this follow these simple steps:
  207.  
  208.            1] With the desired menu in view, right-click on the list
  209.               of menu item, and click "Add"
  210.  
  211.            2] When the menu item properties window pops up, enter the
  212.               command of your choice from the list, or by typing it
  213.               in the text window provided.
  214.  
  215.            3] In the description field, enter only a hyphen "-".  
  216.  
  217.            4] Make sure that the access level required for this item
  218.               is set for the security levels you wish to have see it.
  219.  
  220.            5] Click okay to save this new command.  Now wherever you
  221.               place this command, a separator will appear on your
  222.               pull-down menu.
  223.             
  224.       A new feature of PD Menu 3.0, is it's ability to accomodate more
  225.       items than prior versions would.   Wildcat! limits the amount of
  226.       menu commands to 40, and PD Menu 3.0+ is now able to handle them
  227.       all if configured properly.
  228.  
  229.       When displaying a menu,  PD Menu will check to see how close the
  230.       bottom of the menu is to the bottom of the screen.   If the menu
  231.       gets too close,  it will create another menu right along side of
  232.       the original one, displaying all the commands to the caller.  If
  233.       you position your menus to close to the center though,  the next
  234.       row of commands will slightly overlap the first. The best way to
  235.       find what works the best for you, is to just play  with the menu
  236.       positioning a bit.
  237.  
  238.  
  239.       
  240.                                                                Page 5
  241.  
  242.       USING THE PD MENU CONFIGURATION PROGRAM (PDMENU.WCX)
  243.       ________________________________________________________________
  244.       PDMENU.WCX allows you to edit the properties of each menu,  edit
  245.       the description for the different background menus, and select a
  246.       default background menu.    You can also enter your registration
  247.       number for PD Menu from this menu, once you have registered it.
  248.  
  249.  
  250.       Editing menu properties:
  251.       ________________________________________________________________
  252.       When you select [E]dit menu properties, it starts with the first
  253.       menu defined in wcMenu (normally your main menu).
  254.  
  255.       Available commands:
  256.  
  257.       [M]  Allows you to adjust the horizontal and vertical position.
  258.            When you select this option, you will be able to use your
  259.            cursor keys to adjust the position of a sample menu.
  260.  
  261.       [B]  Allows you to toggle the option of displaying the actual
  262.            menu display file name for the current menu, instead of
  263.            displaying the PDMENU.BBS background instead.  Note that
  264.            this option still displays the Pull-Down menu itself, and
  265.            that this is to provide different backgrounds per menu.
  266.  
  267.       [S]  This option allows you to toggle the option of displaying
  268.            the name of the menu at the top.
  269.  
  270.       [C]  Allows you to toggle between using PD Menu (grey-tone)
  271.            colors, or the menu colors defined in wcConfig.  The colors
  272.            used from wcConfig are listed below
  273.  
  274.       [L]  Toggles the option for clearing the screen before and after
  275.            executing commands.
  276.  
  277.       [N]  Goes to the next menu defined in wcMenu
  278.  
  279.       [P]  Goes to the previous menu defined in wcMenu
  280.  
  281.       [Q]  Quit the program, and return to your Sysop menu
  282.  
  283.       [R]  Allows you to enter your registration number if you have
  284.            not already registered
  285.  
  286.       Each time you press [N]ext or [P]rev, your current menu settings
  287.       are saved.   The actual files you are editing exist in your menu
  288.       directory  (C:\WC5\MENU)  and are named "PDMENUn.CFG"  where the
  289.       n is equal to the menu number as defined in wcMenu.
  290.  
  291.       PD Menu version 3.30 and above now include a  sysop-configurable
  292.       "Task Bar".   You should find the settings for this optional new
  293.       to be self-expanatory.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                                                Page 6
  301.  
  302.       CHANGING THE COLOR OF YOUR MENUS
  303.       ________________________________________________________________
  304.       You can now use Wildcat's user-defined menu colors from wcConfig
  305.       by toggling option "[C] Use PD Menu Color" to "No". PD Menu will
  306.       then use the following color codes:
  307.  
  308.             Menu Title and Hotkeys:  @P@
  309.             Menu Item descriptions:  @Q@
  310.             Menu Highlight color  :  @O@
  311.             Menu Shadow color     :  @S@
  312.  
  313.       This means that you can change the color of all your PD Menus by
  314.       simply changing them in wcConfig_Colors.
  315.  
  316.  
  317.       DESCRIBING EACH OF YOUR BACKGROUND MENUS
  318.       ________________________________________________________________
  319.       You may want to change the  descriptions of your menus from time
  320.       to time,  and it can be done by selecting  [D]escribe background
  321.       menus.   This is  particularly helpful when you want to use your
  322.       own menus.  To change the description of a background menu,  all
  323.       you need to do is select the menu you want to change (1-8),  and
  324.       you will be prompted to enter a new description.
  325.  
  326.  
  327.       USING YOUR OWN ANSI MENUS WITH PD MENU
  328.       ________________________________________________________________
  329.       You will notice that in  your  menu directory,  you have 8 files
  330.       named PDMENUn.BBS,  and one file called PDMENU.BBS.  The 8 files
  331.       that  include a number,  are associated with the number provided
  332.       when selecting a background menu.  You,  the SysOp, can select a
  333.       menu to be used as a default,  which  will be copied,  and named
  334.       PDMENU.BBS.   When the user selects a menu,  it is recorded in a
  335.       data file,  and  will not change the default menu  that you have
  336.       pre-selected.   When the caller  returns  to  your BBS,  PD Menu
  337.       reads this data file,  and uses  only the menu that they prefer.
  338.       Remember that if you don't  want to give your users this option,
  339.       you can simply remove the  program PDUSER.WCX from the menu,  or
  340.       change the access required to run it.
  341.       
  342.       To use your own menus,  just remember to copy, or rename them to
  343.       PDMENUn.BBS,  and  then change the  description for that menu by
  344.       running  PDMENU.WCX (Configuration),  and selecting [D]-Describe
  345.       background menus.     
  346.  
  347.  
  348.       SELECTING YOUR OWN PERSONAL BACKGROUND MENU
  349.       ________________________________________________________________
  350.       You,  and your users can use PDUSER.WCX to select the background
  351.       menu of your choice.  By using this program,  you can select one
  352.       of the eight available background menus you have available.
  353.  
  354.       Once you  have selected the  background you prefer,  your choice
  355.       is saved,  and will be used next time you login as well.  Giving
  356.       your users the option to select their  own menus will not affect
  357.       the menu that you select to be used as the default.
  358.  
  359.  
  360.                                                                 PAGE 7
  361.  
  362.       All selections are  saved to a filed  called PDMUSER.DAT in your
  363.       menu  directory.   Each user will take up 61  bytes.   To figure
  364.       out how large  this file will be,  multiply  this  number by the
  365.       amount of users you have.  
  366.  
  367.  
  368.       DISABLING PD MENU
  369.       ________________________________________________________________
  370.       If you suspect that PD Menu is causing your BBS to crash for any
  371.       reason, you can disable it by running PDMENU.WCX, (configuration
  372.       program),  select [E] to edit the properties of your menus,  and
  373.       select  [D]isable PD Menu.   This will force your BBS to use the
  374.       file WCMENU.WCX,  which is a copy of the original Wildcat!  menu
  375.       system.
  376.  
  377.  
  378.       SHAREWARE NOTICE
  379.       ________________________________________________________________
  380.       This product is released  as shareware,  which means that if you
  381.       continue to  use it for more than the 30-day trial period,  it's
  382.       time to consider registering it with the author.    You can also
  383.       support the shareware concept by "subscribing" to C.L.O.A. which
  384.       registers all wcCode applications for Wildcat! 5.  For more info
  385.       please refer to REGISTER.TXT and CLASS.TXT, both of which should
  386.       always be included with all CLOA wcCode products.
  387.  
  388.       There are no limitations to the un-registered version,  however,
  389.       an intro screen will be displayed when a caller finishes the log
  390.       on process, and enters the menu system.  
  391.  
  392.       DISCLAIMER
  393.       ________________________________________________________________
  394.       By using this, and any other CLOA product,  you assume liability
  395.       for it. The author cannot in any way be held responsible for any
  396.       damages that occur from the use, or misuse of such products.
  397.  
  398.  
  399.       YOUR SUGGESTIONS AND COMMENTS ARE WELCOME
  400.       ________________________________________________________________
  401.       If you have any suggestions on how to improve this, or any other
  402.       CLOA wcCode product, please send them my way!   I appreciate all
  403.       the input I can get!   See the top of this document for where to
  404.       contact me.
  405.  
  406.       AKNOWLEDGEMENTS
  407.       ________________________________________________________________
  408.       My thanks to the folks at MSI for continuing  to provide us with
  409.       the very finest in BBS software,  and the supurb means for which
  410.       to customize it!  
  411.  
  412.       My BIG thanks go out to all my  alpha and beta testers!  I could
  413.       never write such quality software without every one of you!
  414.       My warmest regards to all the folks that have supported my never
  415.       ending quest to provide  top-quality wcCode products to Wildcat!
  416.       SysOps around the world.
  417.  
  418.  
  419.